home *** CD-ROM | disk | FTP | other *** search
/ Workbench Add-On / Workbench Add-On - Volume 1.iso / DiskUtil / CD-ROM / CDDA / CDDA.doc < prev    next >
Text File  |  1994-01-30  |  4KB  |  100 lines
  1. This  is a tiny documentation for `CDDA', a program to replay digitial
  2. audio  data  read  from an Apple CD-300 CD-ROM drive. You will get the
  3. same  information  if  you invoke the program by entering "CDDA ?" and
  4. then entering "?" again.
  5.  
  6. The  source code was written in `C', compiled with SAS/C 6.51. Execute
  7. the source code to compile.
  8.  
  9. If you wish to get into contact with me, write to:
  10.  
  11.    Olaf Barthel
  12.    Brabeckstraße 35
  13.    D-30559 Hannover
  14.  
  15.    Federal Republic of Germany
  16.  
  17.    eMail: olsen@sourcery.han.de
  18.  
  19.                                   *
  20.  
  21. This  program  replays  digital audio data directly off a compact disc
  22. using  the Amiga audio hardware (in stereo where available). A special
  23. type  of  CD-ROM  drive  is required since this program makes use of a
  24. vendor  unique command supported by Sony drives, such as the CDU-8003A
  25. or the Apple CD-300 drive.
  26.  
  27. Please  note  that due to the work involved reading and converting the
  28. audio  data  music may not always play smoothly. The program will also
  29. consume  large  amounts  of  chip memory in order to supply the player
  30. task  with  a  contiguous  stream of data (the maximum number of sound
  31. queue  packets  can  be adjusted using a command line parameter). Your
  32. system  may also experience heavy task loading since the incoming data
  33. (more  than  88K  bytes  per  second)  must  be  handled  quickly  and
  34. efficiently in order to avoid `pops' and delays.
  35.  
  36. The command line template looks like this:
  37.  
  38. DEVICE/K,UNIT/K/N,TRACK/N,FROM/K/N,TO/K/N,NUM/K/N,MAX/K/N,VERBOSE/S
  39.  
  40. DEVICE  This parameter requires a keyword. By default the program will
  41.         address `scsi.device' as the device driver which controls your
  42.         CD-ROM  drive.  You  can  override this by using the following
  43.         command line option:
  44.  
  45.                         DEVICE <device name>
  46.  
  47.         Example:        DEVICE gvpscsi.device
  48.  
  49. UNIT    This parameter requires a keyword. By default the program will
  50.         expect  your  CD-ROM drive to respond to device unit number 2.
  51.         You  can  override  this  by  using the following command line
  52.         options:
  53.  
  54.                         UNIT <unit number>
  55.  
  56.         Example:        UNIT 3
  57.  
  58. TRACK   This  parameter  requires  a keyword. Each data/music track on
  59.         the CD has a unique number assigned which ranges from 1 to 99.
  60.         This is how you choose which track to replay.
  61.  
  62.         Example:        TRACK 1
  63.  
  64. FROM    This  parameter requires a keyword. The CD consists of several
  65.         sectors, each of which can be addressed independently. Several
  66.         sectors form a track, 75 sectors of data make up one second of
  67.         audio  data.  This  is how you choose which sectors to replay,
  68.         note  that  this  parameter  requires  the  "TO"  or the "NUM"
  69.         parameter.
  70.  
  71.         Example:        FROM 1 TO 600
  72.  
  73. TO      This  parameter  requires  a  keyword.  It works both with the
  74.         "TRACK" and "FROM" parameters.
  75.  
  76.         Example:        TRACK 1 TO 5    Plays tracks to 1 to 5
  77.                         FROM 1 TO 600   Plays sectors 1 to 600
  78.  
  79. NUM     This  parameter  requires  a  keyword.  It works both with the
  80.         "TRACK" and "FROM" parameters.
  81.  
  82.         Example:        TRACK 3 NUM 7   Plays tracks to 3 to 10
  83.                         FROM 2 NUM 4    Plays sectors 2 to 6
  84.  
  85. MAX     This  parameter  requires  a  keyword.  In  order  to  feed  a
  86.         contiguous  stream  of  data to the player task incoming audio
  87.         data  is  queued. The maximum number of data packets queued is
  88.         set  using this parameter. By default the number of packets is
  89.         set to 3. Each packet requires about 176K bytes, so take care.
  90.  
  91.         Example:        MAX 5
  92.  
  93. VERBOSE This command line option will enable some more or less helpful
  94.         progress messages, may not be of any use at all.
  95.  
  96.         Example:        VERBOSE
  97.  
  98. That's  all  folks!  This program and the accompanying source code are
  99. freeware. Respect copyright, encourage creativity.
  100.